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Foreword 



rd , 



This Technical Specification has been produced by the 3 Generation Partnership Project (3 GPP). 

The contents of the present document are subject to continuing work within the TSG and may change following formal 
TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an 
identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

X the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 



Introduction 

The present document is part of a TS-family covering the 3^^ Generation Partnership Project; Technical Specification 
Group Services and System Aspects; Telecommunication management; as identified below: 

32.61 1 : "Configuration Management (CM); Bulk CM Integration Reference Point (IRP): Requirements". 

32.612: "Configuration Management (CM); Bulk CM Integration Reference Point (IRP): Information 

Service (IS)". 

32.613: "Configuration Management (CM); Bulk CM Integration Reference Point (IRP): Common 

Object Request Broker Architecture (CORBA) Solution Set (SS)". 

32.615: "Configuration Management (CM); Bulk CM Integration Reference Point (IRP): extensible 

Markup Language (XML) file format definition" . 

32.617: "Configuration Management (CM); Bulk CM Integration Reference Point (IRP): SOAP Solution 

Set(SS)". 

Configuration Management (CM), in general, provides the operator with the ability to assure correct and effective 
operation of the 3G network as it evolves. CM actions have the objective to control and monitor the actual configuration 
on the Network Element (NEs) and Network Resources (NRs), and they may be initiated by the operator or functions in 
the Operations Systems (OSs) or NEs. 

CM actions may be requested as part of an implementation programme (e.g. additions and deletions), as part of an 
optimisation programme (e.g. modifications), and to maintain the overall Quality of Service. The CM actions are 
initiated either as a single action on a NE of the 3G network or as part of a complex procedure involving actions on 
many NEs. 
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Scope 



The purpose of this Bulk CM IRP: CORBA Solution Set is to define the mapping of the IRP Information Service 
3GPP TS 32.612 [3] to the protocol specific details necessary for implementation of this IRP in a CORBA/IDL 
environment. 

This Solution Set specification is related to 3GPP TS 32.612 V9.1.X. 



References 



The following documents contain provisions which, through reference in this text, constitute provisions of the present 
document. 

• References are either specific (identified by date of publication, edition number, version number, etc.) or 
non-specific. 

• For a specific reference, subsequent revisions do not apply. 

• For a non-specific reference, the latest version applies. In the case of a reference to a 3GPP document (including 
a GSM document), a non-specific reference implicitly refers to the latest version of that document in the same 
Release as the present document. 

[I] 3GPP TS 32.101: "Telecommunication management; Principles and high level requirements". 

[2] 3GPP TS 32.102: "Telecommunication management; Architecture". 

[3] 3GPP TS 32.612: "Telecommunication management; Configuration Management (CM); Bulk CM 

Integration Reference Point (IRP); Information Service (IS)". 

[4] 3GPP TS 32.622: "Telecommunication management; Configuration Management (CM); Generic 

network resources Integration Reference Point (IRP): Network Resource Model (NRM)". 

[5] 3GPP TS 32.300: "Telecommunication management; Configuration Management (CM); Name 

convention for Managed Objects". 

[6] OMG Notification Service, Version 1.0. 

[7] OMG CORBA services: Common Object Services Specification, Update: November 22, 1996. 

[8] The Common Object Request Broker: Architecture and Specification (for specification of valid 

version, see [1]). 

[9] 3GPP TS 32.303: "Telecommunication management; Configuration Management (CM); 

Notification Integration Reference Point (IRP): Common Object Request Broker Architecture 
(CORBA) Solution Set (SS)". 

[10] 3GPP TS 32.1 1 1-3: "Telecommunication management; Fault Management; Part 3: Alarm 

Integration Reference Point (IRP): Common Object Request Broker Architecture (CORBA) 
Solution Set (SS)". 

[II] 3GPP TS 32.642: "Telecommunication management; Configuration Management (CM); UTRAN 
network resources Integration Reference Point (IRP): Network Resource Model (NRM)". 

[12] 3GPP TS 32.652: "Telecommunication management; Configuration Management (CM); GERAN 

network resources Integration Reference Point (IRP): Network Resource Model (NRM)". 

[13] 3GPP TS 32.312: "Telecommunication management; Generic Integration Reference Point (IRP) 

management; Information Service (IS)". 

[14] 3GPP TS 32.632: "Telecommunication management; Configuration Management (CM); CN 

network resources Integration Reference Point (IRP): Network Resource Model (NRM)". 
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[15] 3GPP TS 32.692 "Inventory Management (IM) network resources Integration Reference Point 

(IRP): Network Resource Model (NRM)". 

[16] 3GPP TS 32.742: "Telecommunication management; Configuration Management (CM); 

Signalling Transport Network (STN) Interface Network Resource Model (NRM) Integration 
Reference Point (IRP): Information Service (IS)". 

[17] 3GPP TS 32.712: "Telecommunication management; Configuration Management (CM); Transport 

Network (TN) Network Resource Model (NRM) Integration Reference Point (IRP): Information 
Service (IS)". 

[18] 3GPP TS 32.732: "IP Multimedia Subsystem (IMS) Network Resource Model (NRM) Integration 

Reference Point (IRP): Information Service (IS)". 

[19] 3GPP TS 32.762: "Telecommunication management; Evolved Universal Terrestrial Radio Access 

Network (E UTRAN) Network Resource Model (NRM) Integration Reference Point (IRP): 
Information Service (IS)". 

[20] 3GPP TS 32.752: "Telecommunication management; Evolved Packet Core (EPC) Network 

Resource Model (NRM) Integration Reference Point (IRP): Information Service (IS)". 

[21] 3GPP TS 32.522: "Telecommunication management; Self-Organizing Networks (SON) Policy 

Network Resource Model (NRM) Integration Reference Point (IRP): Information Service (IS)". 

[22] 3GPP TS 32.172: "Telecommunication management; Subscription Management (SuM) Network 

Resource Model (NRM) Integration Reference Point (IRP): Information Service (IS)". 

[23] 3GPP TS 32.722: "Telecommunication management; Configuration Management (CM); Repeater 

network resources Integration Reference Point (IRP); information Service (IS)". 

[24] 3GPP TS 32.772: "Telecommunication management; Home Node B (HNB) Subsystem (HNS); 

Network Resource Model (NRM); Integration Reference Point (IRP): Information Service (IS)". 

[25] 3GPP TS 32.782: "Telecommunication management; Home enhanced Node B (HeNB) Subsystem 

(HeNS); Network Resource Model (NRM); Integration Reference Point (IRP): Information 
Service (IS)". 



3 Definitions and abbreviations 

3.1 Definitions 

For terms and definitions please refer to 3GPP TS 32.101 [1], TS 32.102 [2], TS 32.612 [3], TS 32.622 [4], 

TS 32.632 [14], TS 32.642 [11], TS 32.652 [12], TS 32.692 [15], TS 32.742 [16], TS 32.712 [17], TS 32.732 [18], TS 

32.762 [19], TS 32.752 [20], TS 32.522 [21], TS 32.172 [22], TS 32.722 [23], TS 32.772 [24] and TS 32.782 [25]. 

• IRP document version number string (or "IRP Version"): See 3GPP TS 32.312 [13]. 

3.2 Abbreviations 

For the purposes of the present document, the following abbreviations apply: 

CORBA Common Object Request Broker Architecture 

DN Distinguished Name 

IS Information Service 

IDL Interface Definition Language (OMG) 

IRP Integration Reference Point 

MO Managed Object 

MOC Managed Object Class 

NRM Network Resource Model 

OMG Object Management Group 
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4 Mapping 

4.1 General Mappings 

All MOs are arranged in a containment structure, according to the containment relations defined in the NRM. This 
structure is held internally by the IRP Agent. Externally, the MO containment structure is defined by the semantics in 
the distinguished name syntax. The distinguished name (DN) for a MO contains the distinguished name of the parent 
plus the Relative DN for the MO itself. 

Associations as defined in the NRM (UML) are in this document mapped to attributes in the MIB. The names of the 
roles for an association in the NRM are used for defining attribute names in the MIB. When the cardinality for a role is 
0..1 or 1..1 the datatype for the attribute is defined as a MO reference. The value of a MO reference contains the 
distinguished name of the referred MO. When the cardinality for a role allows more than one referred MO instances, 
the attribute will contain a sequence of MO references (i.e., DNs). 

4.2 Operation and Notification mapping 

The IS part of Bulk CM: IRP defines semantics of operations and notifications visible across the Bulk Configuration 
IRP. The table below indicates mapping of these operations and notifications to their equivalents defined in this 
document. 

There are 3 qualifications for each row of the following mapping table. 

The 3 qualifications correspond to the three IS-defined packages: Controlled Upload & Provisioning, Controlled Upload 

and Simple Upload. 

Not all operations/notifications specified in the following table are required for all 3 packages. 

An "-" indicates that the subject operation or notification is not allowed by that corresponding package. 
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Table 1 : Mapping from IM Notification/Operation to SS equivalents 



IS Operation/ notification 


SS Method 


Qualifier 


startSession 


start_session 


M,M,- 


endSession 


end_session 


M,M,- 


upload 


upload 


M,M,M 


download 


download 


M,-r 


activate 


activate 


M,-,- 


getSessionStatus 


get_session_status 


M,M,- 


getSessionlds 


get_session_ids 


M,M,- 


getSessionLog 


get_session_log 


M,M,- 


fallback 


fallback 


M,-r 


abortSessionOperation 


abort_session_operation 


M,M,- 


getlRPVersion 


get_bulk_cm_irp_versions 

get_controlled_upload_bulk_cm_irp_versions 

get_simple_upload_bulk_cm_irp_versions 


-,M,- 
-,-,M 


notifySessionStateChanged 


push_structured_event 

Note that OMG Notification Service OMG Notification Service 

[1] defines this method. 

See clause 5.1 


M,M,M 


notifyGetSessionLogEnded 


push_structured_event 

Note that OMG Notification Service OMG Notification Service 

[1] defines this method. 

See clause 5.1. 


M,M,- 


preactivate 


preactivate 


0,-,- 


validate 


validate 


0,-r 


getOperationProfile 


get_bulk_cm_irp_operation_profile 

get_controlled_upload_bulk_cm_irp_operation_profile 

get_simple_upload_bulk_cm_irp_operation_profile 


0,-,- 

-,o,- 

-,-,0 


getNotificationProfile 


get_bulk_cm_irp_notification_profile 

get_controlled_upload_bulk_cm_irp_notification_profile 

get_simple_upload_bulk_cm_irp_notification_profile 


0,-,- 

-,o,- 

-,-,0 



4.3 Operation Parameter Mapping 

Reference Bulk CM IRP; Information Service [3] defines semantics of parameters carried in operations. The tables 
below indicate the mapping of these parameters, as per operation, to their equivalents defined in this SS. 

Table 2: Mapping from IS startSession parameters to SS equivalents 



IS Operation parameter 


SS parameter 


Qualifier 


sessionid 


BulkCmlRPConstDefs::Sessionld sessionjd 


M 


status 


Exceptions: 

StartSessionException, SessionldlnUseException, 

MaxSessionReached Exception, 

ManagedGenericlRPSystem::lnvalidParameter 


M 



Table 3: Mapping from IS endSession parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


sessionid 


BulkCmlRPConstDefs::Sessionld sessionjd 


M 


status 


Exceptions: 

EndSessionException, UnknownSessionldException, 

NotValidlnCurrentStateException, 

ManagedGenericlRPSystem::lnvalidParameter 


M 
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Table 4: Mapping from IS upload parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


sessionid 


BulkCmlRPConstDefs::Sessionld sessionjd 


M 


uploadDataFileReference 


BulkCmlRPConstDefs::FileDestination sink 


M 


baseObjectlnstance 


BulkCmlRPConstDefs::DistinguishedName base_object 


M 


scope, filter 


BulkCmlRPConstDefs::SearchControl search_control 


M 


status 


Exceptions: 

UploadException, UnknownSessionldException, 

MaxSessionReachedException, NotValidlnCurrentStateException, 

ConcurrencyException, lllegalDNFormatException, 

lllegalFilterFormatException, lllegalScopeTypeException, 

lllegalScopeLevelException, lllegalURLFormatException, 

ManagedGenericlRPSystem::lnvalidParameter 


M 


NOTE: The lllegalURLFormatException does not imply that the transfer protocol used must be a URL. The transfer 
protocol is dependant on the file format definition, i.e. in the case of XML, FileDestination will be a URL. 



Table 5: Mapping from IS download parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


sessionid 


BulkCmlRPConstDefs::Sessionld sessionjd 


M 


downloadDataFileReference 


BulkCmlRPConstDefs::FileDestination source 


M 


status 


Exceptions: 

DownloadException, UnknownSessionldException, 

MaxSessionReachedException, 

NotValidlnCurrentStateException, 

lllegalURLFormatException, 

ManagedGenericlRPSystem::lnvalidParameter 


M 


NOTE: The lllegalURLFormatException does not imply that the transfer protocol used must be a URL. The transfer 
protocol is dependant on the file format definition, i.e. in the case of XML, FileDestination will be a URL. 



Table 6: Mapping from IS activate parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


sessionid 


BulkCmlRPConstDefs::Sessionld sessionjd 


M 


activationMode 


BulkCmlRPConstDefs::ActivationModeTypeOpt activation_mode 





fallbackEnabled 


boolean fallback 


M 


status 


Exceptions: 

Activate Exception, UnknownSessionldException, 

NotValidlnCurrentStateException, ConcurrencyException, 

lllegalActivationModeException, 

ManagedGenericlRPSystem::ParameterNotSupported, 

ManagedGenericlRPSystem::lnvalidParameter 


M 



Table 7: Mapping from IS fallback parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


sessionid 


BulkCmlRPConstDefs::Sessionld sessionjd 


M 


status 


Exceptions: 

FallbackException, UnknownSessionldException, 

NoFallbackException, NotValidlnCurrentStateException, 

ConcurrencyException, 

ManagedGenericlRPSystem::lnvalidParameter 


M 
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Table 8: Mapping from IS abortSessionOperation parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


sessionid 


BulkCmlRPConstDefs::Sessionld sessionjd 


M 


status 


Exceptions: 

AbortSessionOperationException, 

UnknownSessionldException, 

NotValidlnCurrentStateException, 

ManagedGenericlRPSystem::lnvalidParameter 


M 



Table 9: Mapping from IS getSessionlds parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


sessionldList 


Return value of type BulkCmlRPConstDefs::SessionldList 


M 


status 


Exceptions: 

GetSessionldsException, 

l\/lanagedGenericlRPSystem::lnvalidParameter 


M 



Table 10: Mapping from IS getSessionStatus parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


sessionid 


BulkCmlRPConstDefs::Sessionld sessionjd 


M 


sessionState 


Return value of type BulkCmlRPConstDefs::SessionState 


M 


Not specified in IS 


BulkCmlRPConstDefs::Errorlnformation errorjnformation 


M 


status 


Exceptions: 

GetSessionStatusException, UnknownSessionldException, 

ManagedGenericlRPSystem::lnvalidParameter 


M 



Table 11 : Mapping from IS getSessionLog parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


sessionid 


BulkCmlRPConstDefs::Sessionld sessionjd 


M 


logFileReference 


BulkCmlRPConstDefs::FileDestination sink 


M 


contentType 


boolean only_error_info 


M 


status 


Exceptions: 

GetSessionLogException, UnknownSessionldException, 

lllegalURLFormatException, 

ManagedGenericlRPSystem::lnvalidParameter 


M 


NOTE: The lllegalURLFormatException does not imply that the transfer protocol used must be a URL. The transfer 
protocol is dependant on the file format definition, i.e. in the case of XML, FileDestination will be a URL. 



Table 12: Mapping from IS getBulkCmlRPVersion parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


versionNumberList 


Return value of type 
ManagedGenericlRPConstDefs::VersionNumberSet 


M 


status 


Exceptions: 
GetBulkCmlRPVersionsException 


M 
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Table 13: Mapping from IS validate parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


sessionid 


BulkCmlRPConstDefs::Sessionld sessionjd 


M 


activationMode 


BulkCmlRPConstDefs::ActivationModeTypeOpt activation_mode 





status 


Exceptions: 

ValidateException , UnknownSessionldException, 

NotValidlnCurrentStateException, ConcurrencyException, 

lllegalActivationModeException, 

ManagedGenericlRPSystem::ParameterNotSupported, 

ManagedGenericlRPSystem::lnvalidParameter, 

ManagedGenericlRPSystem::OperationNotSupported 


M 



Table 14: Mapping from IS preactivate parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


sessionid 


BulkCmlRPConstDefs::Sessionld sessionjd 


M 


verificationlVlode 


BulkCmlRPConstDefs::Verificationl\/lodeTypeOpt verification_mode 





activationlVlode 


BulkCmlRPConstDefs::Activationl\/lodeTypeOpt activation_mode 





fallbackEnabled 


boolean fallback 


M 


status 


Exceptions: 

PreactivateException, UnknownSessionldException, 

NotValidlnCurrentStateException, ConcurrencyException, 

lllegalActivationModeException, lllegalVerificationModeException, 

ManagedGenericlRPSystem::ParameterNotSupported, 

ManagedGenericlRPSystem::lnvalidParameter, 

ManagedGenericlRPSystem::OperationNotSupported 


M 



Table 15: Mapping from IS getOperationProfile parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


irpVersion 


ManagedGenericlRPConstDefs::VersionNumber 
bulk_cm_irp_version 


M 


operationNameProfile, 
operationParameterProfile 


Return value of type 
ManagedGenericlRPConstDefs::MethodList 


M 


status 


Exceptions: 

GetBulkCMIRPOperationProfileException, 
ManagedGenericlRPSystem::OperationNotSupported, 
ManagedGenericlRPSystem::lnvalidParameter 


M 



Table 16: Mapping from IS getNotificationProfile parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


irpVersion 


ManagedGenericlRPConstDefs::VersionNumber 
bulk_cm_irp_version 


M 


notificationNameProfile, 
notificationParameterProfile 


Return value of type 
ManagedGenericlRPConstDefs::MethodList 


M 


status 


Exceptions: 

GetBulkCMIRPNotificationProfileException, 
ManagedGenericlRPSystem::OperationNotSupported, 
ManagedGenericlRPSystem::lnvalidParameter 


M 



ETSI 



3GPP TS 32.613 version 9.1.0 Release 9 



13 



ETSI TS 1 32 61 3 V9.1 .0 (201 1 -01 ) 



4.4 Notification parameter mapping 



Reference 3G TS 32.612 [3] defines semantics of parameters carried in notifications. The following tables indicate the 
mapping of these parameters to their OMG CORBA Structured Event (defined in OMG Notification Service [6]) 
equivalents. The composition of OMG Structured Event, as defined in the OMG Notification Service [6], is: 



Header 



Body 



Fixed Header 

domain_name 

type_name 

event_name 
Variable Header 

f ilterable_body_f ields 
remaining_body 



The following tables list all OMG Structured Event attributes in the second column. The first column identifies the 
Bulk CM IRP: IS [3] defined notification parameters. 



Table 17: Mapping from IS notifyGetSession Log Ended parameters to SS equivalents 



IS Parameter 


OMG CORBA 

Structured Event 

Attribute 


Qualifier 


Comment 


There is no 
corresponding IS 
attribute. 


domain_name 


M 


It carries the IRP document version number string. See sub- 
clause 3.3. 

It indicates the syntax and semantics of the Structured Event 
as defined by this specification. 


notificationType 


type_name 


M 


It carries the string NOTIFY_GET_SESSION_LOG_ENDED. 


sessionLogStatus 


event_name 


M 


It carries either the string 

GET SESSION LOG COMPLETED SUCCESSFULLY or 

GET_SESSION_LOG_COMPLETED_UNSUCCESSFULLY. 

In the case of the latter, the NV pair indicating 

ERRORJNFORMATION may be present. 


There is no 
corresponding IS 
attribute. 


Variable Header 






managedObjectClass, 
managedObjectlnstance 


One NV pair of 
filterable_body_fields 


M 


NV stands for name-value pair. Order arrangement of NV 
pairs is not significant. The name of NV-pair is always 
encoded in string. 

Name of NV pair is the MANAGED_OBJECT_INSTANCE of 
interface AttributeNameValue of module 
NotificationlRPConstDefs. 

Value of NV pair is a string. See encoding of this string in 

[5]. 

These are attributes of Header defined in the IS. 


notificationid 


One NV pair of 
remaining_body 


M 


Name of NV pair is the NOTIFICATIONJD of interface 
AttributeNameValue of module NotificationlRPConstDefs. 

Value of NV pair is a long. 

This is an attribute of Header defined in the IS. 


eventTime 


One NV pair of 
filterable_body_fields 


M 


Name of NV pair is the EVENT_TIME of interface 
AttributeNameValue of module NotificationlRPConstDefs. 

Value of NV pair is a IRPTime. 

This is an attribute of Header of the IS. 
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IS Parameter 


OMG CORBA 

Structured Event 

Attribute 


Qualifier 


Comment 


system DN 


One NV pair of 
filterable_body_fields 


M 


Name of NV pair is the SYSTEI\/I_DN of interface 
AttributeNameValue of module NotificationlRPConstDefs. 

Value of NV pair is a string. 

This is an attribute of Header defined in the IS. 


sessionid 


One NV pair of 
remaining_body 


M 


Name of NV pair is the SESSIONJD of interface 
NotifyGetSessionLogEnded of module 
BulkCMIRPNotifications. 

Value of NV pair is a string. 


sourcelndicator 


One NV pair of 
remaining_body 





Name of NV pair is the SOURCEJNDICATOR of interface 
NotifyGetSessionLogEnded of module 
BulkCMIRPNotifications. 

Value of NV pair is a string. 


There is no 
corresponding IS 
attribute. 


One NV pair of 
remaining_body 


M 


Name of NV pair is the ERRORJNFORMATION of interface 
NotifyGetSessionLogEnded of module 
BulkCMIRPNotifications. 

Value of NV pair is a string. 
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Table 18: Mapping from IS notifySessionStateChanged parameters to SS equivalents 



IS Parameter 


OMG CORBA 

Structured Event 

attribute 


Qualifier 


Comment 


There is no corresponding IS 
attribute. 


domain_name 


M 


It carries the IRP document version number 

string. See sub-clause 3.3. 

It indicates the syntax and semantics of the 

Structured Event as defined by this 

specification. 


notificationType 


type_name 


M 


It carries the string 

NOTIFY_SESSION_STATE_CHANGED. 
This is an attribute of Header defined in the 
IS. 


sessionState 


event_name 


M 


It carries one of the following: 

UPLOAD FAILED, UPLOAD COMPLETED, 

DOWNLOAD FAILED, 

DOWNLOAD COMPLETED, 

ACTIVATION FAILED, 

ACTIVATION PARTLY REALISED, 

ACTIVATION COMPLETED, 

FALLBACK FAILED, 

FALLBACK PARTLY REALISED, 

FALLBACK COMPLETED, 

VALIDATION FAILED, 

VALIDATION COMPLETED, 

PREACTIVATION FAILED, 

PREACTIVATION PARTLY REALISED, 

PREACTIVATION_COMPLETED. 

In the case of XXX FAILED and 

XXX PARTLY REALISED, the NV pair 

indicating ERRORJNFORMATION may be 

present. 


There is no corresponding IS 
attribute. 


Variable Header 






managedObjectClass, 
managedObjectlnstance 


One NV pair of 
filterable_body_fields 


M 


NV stands for name-value pair. Order 
arrangement of NV pairs is not significant. 
The name of NV-pair is always encoded in 
string. 

Name of NV pair is the 

MANAGED_OBJECT_INSTANCE of interface 
AttributeNameValue of module 
NotificationlRPConstDefs. 

Value of NV pair is a string. See encoding of 

this string in [5]. 

These are attributes of Header defined in the 

IS. 


notificationid 


One NV pair of 
remaining_body 


M 


Name of NV pair is the NOTIFICATIONJD of 
interface AttributeNameValue of module 
NotificationlRPConstDefs. 

Value of NV pair is a long. 

This is an attribute of Header defined in the 

IS. 


eventTime 


One NV pair of 
filterable_body_fields 


M 


Name of NV pair is the EVENT_TIME of 
interface AttributeNameValue of module 
NotificationlRPConstDefs. 

Value of NV pair is a IRPTime. 

This is an attribute of Header of the IS. 
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IS Parameter 


OMG CORBA 

Structured Event 

attribute 


Qualifier 


Comment 


system DN 


One NV pair of 
filterable_body_fields 


M 


Name of NV pair is the SYSTEM_DN of 
interface AttributeNameValue of module 
NotificationlRPConstDefs. 

Value of NV pair is a string. 

This is an attribute of Header defined in the 

IS. 


sessionid 


One NV pair of 
remaining_body 


M 


Name of NV pair is the SESSIONJD of 
interface NotifySessionStateChange of 
module BulkCMIRPNotifications. 

Value of NV pair is a string. 


sourcelndicator 


One NV pair of 
remaining_body 





Name of NV pair is the 
SOURCEJNDICATOR of interface 
NotifySessionStateChange of module 
BulkCMIRPNotifications. 

Value of NV pair is a string. 


There is no corresponding IS 
attribute. 


One NV pair of remaining 
_body 


M 


Name of NV pair is the 
ERROR_INFORMATION of interface 
NotifySessionStateChange of module 
BulkCMIRPNotifications. 

Value of NV pair is a string. 



4.5 Two modes of operations 



The upload, download, validate, preactivate, activate, get_session_log, and fallback are methods that use asynchronous 
mode of operation. The IRPManager uses the methods to request a task to be done. The IRP Agent, via the method 
return, indicates that it has understood the request and has begun to perform the task requested. When the IRP Agent 
has completed the requested task, either successfully or not, the IRP Agent will emit a notification, e.g., 
notifySessionStateChangedO defined in IS level and mapped to push() in SS level, to indicate the completion status of 
the requested task. If the IRPManager has subscribed (e.g., via the attach_push() of Notification IRP) for notifications, 
then the IRPManager will receive the notification. 

The start_session, end_session, abort_session_operation, get_session_status, get_session_ids, 
get_bulk_CM_IRP_operation_profile, get_bulk_CM_IRP_notification_profile and get_bulkCM_IRP_version are 
methods that use synchronous mode of operation. The IRPManager uses these methods to request some information or 
a task to be done. The IRP Agent performs the requested task and, via the method return, indicates the requested 
information or if the requested task has completed successfully or not. 
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4.6 Mapping from IS State Names to SS equivalents 

State names, as defined in the IS part of Bulk CM, consists of two sub-parts in this SS, namely SubPhase and SubState. 
The table below shows the mapping between these substates and the IS state name. All combinations of SubPhase and 
SubState not described below are considered invalid. 

Table 19: Mapping from IS State Names to SS equivalents 



IS state Name 


SS SubPhase 


SS SubState 


IDLE 


IDLE PHASE 


COMPLETED 


UPLOAD FAILED 


UPLOAD PHASE 


FAILED 


UPLOAD IN PROGRESS 


UPLOAD PHASE 


IN PROGRESS 


UPLOAD COMPLETED 


UPLOAD PHASE 


COMPLETED 


DOWNLOAD FAILED 


DOWNLOAD PHASE 


FAILED 


DOWNLOAD IN PROGRESS 


DOWNLOAD PHASE 


IN PROGRESS 


DOWNLOAD COMPLETED 


DOWNLOAD PHASE 


COMPLETED 


ACTIVATION FAILED 


ACTIVATION PHASE 


FAILED 


ACTIVATION IN PROGRESS 


ACTIVATION PHASE 


IN PROGRESS 


ACTIVATION COMPLETED 


ACTIVATION PHASE 


COMPLETED 


ACTIVATION PARTLY COMPLETED 


ACTIVATION PHASE 


PARTLY REALISED 


FALLBACK FAILED 


FALLBACK PHASE 


FAILED 


FALLBACK IN PROGRESS 


FALLBACK PHASE 


IN PROGRESS 


FALLBACK COMPLETED 


FALLBACK PHASE 


COMPLETED 


FALLBACK PARTLY COMPLETED 


FALLBACK PHASE 


PARTLY REALISED 


VALIDATION FAILED 


VALIDATION PHASE 


FAILED 


VALIDATION IN PROGRESS 


VALIDATION PHASE 


IN PROGRESS 


VALIDATION COMPLETED 


VALIDATION PHASE 


COMPLETED 


PREACTIVATION FAILED 


PREACTIVATION PHASE 


FAILED 


PREACTIVATION IN PROGRESS 


PREACTIVATION PHASE 


IN PROGRESS 


PREACTIVATION COMPLETED 


PREACTIVATION PHASE 


COMPLETED 


PREACTIVATION PARTLY COMPLETED 


PREACTIVATION PHASE 


PARTLY REALISED 



4.7 



Package Mapping 



The Bulk CM IRP: IS (3GPP TS 32.612 [3]) clause 7 specifies packages of capabilities. 
The IS -defined packages are mapped into IDL module constructs. Specifically: 

• The operations named in the IS-defined packages Simple Upload, Controlled Upload and Controlled Upload & 
Provisioning are mapped to methods in SimpleUploadBulkCMIRSystem::SimpleUploadBulkCMIRP, 
ControlledUploadBulkCMIRPSystem: :ControlledUploadBulkCMIRP and BulkCmlRPSystem: :BulkCmIRP 
respectively (see clause A.2). 

• The notifications named in the IS-defined Simple Upload, Controlled Upload and Controlled Upload & 
Provisioning are mapped to SS Interfaces defined in IDL module BulkCMIRPNotifications (see clause A.3). 
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BulkCMIRPNotifications Interface 



OMG CORB A Notification push operation is used to realise the notification of BulkCMIRPNotifications. All the 
notifications in this interface are implemented using this push_structured_event method. 

5.1 Method push (M) 

module CosNotifyComm { 

Interface SequencePushConsumer : NotifyPublish { 
void push_structured_events( 

in CosNotification::EventBatch notifications) 

raises( CosEventComm: iDisconnected); 

} ; // SequencePushConsumer 

};// CosNotifyComm 

NOTE 1 : The push_structured_e vents method takes an input parameter of type EventBatch as defined in the OMG 
CosNotification module (OMG Notification Service [6]). This data type is the same as a sequence of 
Structured Events. Upon invocation, this parameter will contain a sequence of Structured Events being 
delivered to IRPManager by IRP Agent to which it is connected. 

NOTE 2: The maximum number of events that will be transmitted within a single invocation of this operation is 
controlled by IRP Agent wide configuration parameter. 

NOTE 3: The amount of time the supplier (IRP Agent) of a sequence of Structured Events will accumulate 
individual events into the sequence before invoking this operation is controlled by IRP Agent wide 
configuration parameter as well. 

NOTE 4: IRP Agent may push EventBatch with only one Structured Event. 
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Annex A (normative): 
I DL Specifications 

A.1 IDL specification (file name 
BulkCmlRPConstDefs.idI) 

//File: BulkCmlRPConstDefs.idI 
#ifndef _BULK_CM_IRP_CONST_DEFS_IDL_ 
#define _BULK_CM_IRP_CONST_DEFS_IDL_ 

// This statement must appear after all include statements 
#pragma prefix "3gppsa5.org" 

/* ## Module: BulkCmlRPConstDefs 

This module contains type definitions for the Bulk CM IRP 

*/ 

module BulkCmlRPConstDefs 

{ 

/* 

This block identifies the notification types defined by 

this Bulk CM IRP version. 

This string is used in the second field of the Structured 

Event . 

interface Notif icationType 

{ 

const string NOTIFY_SESSION_STATE_CHANGED = "xl"; 
const string NOTIFY_GET_SESSION_LOG_ENDED = "x2"; 



/* 

This block assigns value for the name of the NV of the Structured Event. 

interface AttributeNameValue 

{ 

const string SESSION_ID = "k"; 
const string SOURCE_INDICATOR = "m" ; 
const string ERROR_INFORMATION = "n" ; 



/* 

This block defines all possible values for sessionState . 
One of these strings appear in the event_name of the 
Structured Event of notif ySessionStateChanged notification. 

interface SessionStateChangeNotif ication 

{ 

const string UPLOAD_FAILED = "xl"; 

const string UPLOAD_COMPLETED = "x2"; 

const string DOWNLOAD_FAILED = "x3"; 

const string DOWNLOAD_COMPLETED = "x4"; 

const string ACTIVATION_FAILED = "x5"; 

const string ACTIVATION_PARTLY_REALISED = "x6"; 

const string ACTIVATION_COMPLETED = "x7"; 

const string FALLBACK_FAILED = "x8"; 

const string FALLBACK_PARTLY_REALISED = "x9"; 

const string FALLBACK_COMPLETED = "xlO"; 

const string VALIDATION_FAILED = "xll"; 

const string VALIDATION_COMPLETED = "xl2"; 

const string PREACTIVATION_FAILED = "xl3"; 

const string PREACTIVATION_PARTLY_REALISED = "xl4"; 

const string PREACTIVATION_COMPLETED = "xl5"; 



/* 

This block defines all possible values for sessionLogStatus 
One of these strings appear in the event_name of the Structured 
Event of notif yOetSessionLogEnded notification. 
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interface LogStateNotif ication 



const string GET_SESSION_LOG_COMPLETED_SUCCESSFULLY = "xl"; 
const string GET_SESSION_LOG_COMPLETED_UNSUCESSFULLY = "x2"; 



For each started configuration session a unique identifier is generated 
by the IRPManager. An sessionid can not be used for an upload if it is 
already in use of a download configuration and vice versa. 

typedef string Sessionid; 

/* 

This string field is used in order to provide additional error information 

if an operation has failed. 

*/ 

typedef string Errorlnformation; 

/* 

Defines the different subphases of a configuration session 
e.g. thus it is easy to implement a detection of an upload 
or a download/activate session. 

enum SubPhase {lDLE_PHASE, DOWNLOAD_PHASE, UPLOAD_PHASE , ACTIVATION_PHASE, 
FALLBACK_PHASE, PREACTIVATION_PHASE , VALIDATION_PHASE } ; 

Defines the different substates of a configuration session. This includes 
the transition state as well. 

enum SubState {COMPLETED, FAILED, PARTLY_REALISED, IN_PROGRESS } ; 

/* 

Defines state of a configuration session with the phase and the substate 

of the configuration. 

struct SessionState 

{ 

SubPhase sub_phase; 
Substate sub_state; 



Contains the list of all current sessionlds 
typedef sequence <SessionId> SessionldList ; 

Specifies a complete destination path (including filename) . 

typedef string FileDestination; 

/* 

The format of Distinguished Name is specified in 

the Naming Conventions for Managed Objects; TS 32.3 00. 

e.g. "SubNetwork=10001,ManagedElement=400001" identifies a 

ManagedElement instance of the object model. 

typedef string DistinguishedName; 

Used within the upload method to give filter critera 

typedef string Filter; 

/* 

Defines the kind of scope to use in a search together with 

SearchControl . level, in a SearchControl value. 

SearchControl . level is always >= . If a level is bigger than the 

depth of the tree there will be no exceptions thrown. 

enum ScopeType {BASE_0NLY, BASE_NTH_LEVEL, BASE_SUBTREE, BASE_ALL} ; 

/* 

Controls the searching for MOs during upload, and contains: 

the type of scope ("type" field), 

the level of scope ("level" field). 
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the filter ("filter_" field), 

The type and level fields are mandatory. 

The filter field is mandatory (The filter will have to be 

set to an empty string if it has no other value) . 

struct SearchControl 

{ 

ScopeType type; 
unsigned long level; 
Filter filter ; 



This indicates how the activation is executed, either with least service 
impact or least elapsed time. 

enum ActivationMode {LEAST_SERVICE_IMPACT, LEAST_ELAPSED_TIME} ; 

This indicates the level of verification of bulk configuration data done, 
either full or limited checking. 

enum VerificationMode {full_CHECKING, LIMITED_CHECKING} ; 

/* ActivationModeTypeOpt is a type carrying an optional parameter. 
If the boolean is TRUE, the value is present. 
Otherwise, the value is absent. 

union ActivationModeTypeOpt switch (boolean) 

{ 

case TRUE: ActivationMode activation_mode; 



/* Verif icationModeTypeOpt is a type carrying an optional parameter. 
If the boolean is TRUE, the value is present. 
Otherwise, the value is absent. 

union Verif icationModeTypeOpt switch (boolean) 

{ 

case TRUE: VerificationMode verif ication_mode; 



}; 



#endif // _BULK_CM_IRP_CONST_DEFS_IDL_ 
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A.2 IDL specification (file Name BulkCMIRPSystem.idI) 

//File: BulkCMIRPSystem.idI 
#ifndef _BULK_CM_IRP_SYSTEM_IDL_ 
#define _BULK_CM_IRP_SYSTEM_IDL_ 

#include <BulkCmIRPConstDef s . idl> 
#include <ManagedGenericIRPConstDef s . idl> 
#include <ManagedGenericIRPSystem. idl> 

// This statement must appear after all include statements 
#pragma prefix "3gppsa5.org" 

/* ## Module: BulkCmlRPSystem 

This module implements capabilities of Bulk CM IRP. 



*/ 

module BulkCmlRPSystem 

{ 

/* 

The request cannot be processed due to a situation of concurrency. 

E.g. two concurrent activation requests involving the same ManagedElement 

instance. The semantics carried in reason is outside the scope of this IRP. 

exception ConcurrencyException { string reason; } ; 

/* 

The provided filter is malformed or invalid. The semantics carried in reason 

is outside the scope of this IRP. 

exception IllegalFilterFormatException { string reason; } ; 

/* 

The provided Distinguished Name is malformed or invalid. The semantics 

carried in reason is outside the scope of this IRP. 

exception IllegalDNFormatException { string reason; } ; 

/* 

The provided scope type is illegal. The semantics carried in reason is 

outside the scope of this IRP. 

exception IllegalScopeTypeException { string reason; } ; 

/* 

The provided scope level is illegal. The semantics carried in reason is 

outside the scope of this IRP. 

exception IllegalScopeLevelException { string reason; } ; 

/* 

The request cannot be processed because no fallback data is available, i.e. 

fallback capability was previously not asked for. 

exception NoFallbackException { } ; 

/* 

The provided sessionid value is already used for another configuration 

session. The semantics carried in reason is outside the scope of this IRP. 

exception SessionldlnUseException { string reason; } ; 

/* 

The provided URL is malformed or invalid. The semantics carried in reason is 

outside the scope of this IRP. 

exception IllegalURLFormatException{ string reason; } ; 

/* 

The provided sessionid value does not identify any existing configuration 

session. 

exception UnknownSessionldException { } ; 

/* 
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The request cannot be processed because it is not valid in the current state 
of the configuration session. 

exception NotValidlnCurrentStateException 

{ 

BulkCmlRPConstDef s : : SessionState current_state; 

}; 

The request cannot be processed because the maximum number of simultaneously 
running configuration sessions has been reached. The semantics carried in 
reason is outside the scope of this IRP. 

exception MaxSessionReachedException { string reason; } ; 

/* 

The provided ActivationMode type is illegal. The semantics carried in reason 

is outside the scope of this IRP. 

exception IllegalActivationModeException { string reason; } ; 

/* 

The provided Verif icationMode type is illegal. The semantics carried in 

reason is outside the scope of this IRP. 

exception IllegalVerif icationModeException { string reason; } ; 

/* 

System otherwise fails to complete the operation. System can provide reason 

to qualify the exception. The semantics carried in reason 

is outside the scope of this IRP. 

exception GetBulkCmlRPVersionsException { string reason; } ; 

exception UploadException { string reason; } ; 

exception DownloadException { string reason; 

exception ActivateException { string reason; 

exception ValidateException { string reason; 

exception PreactivateException { string reason; } ; 

exception GetBulkCMIRPOperationProf ileException { string reason; } ; 

exception GetBulkCMIRPNotificationProf ileException { string reason; } ; 

exception GetSessionLogException { string reason; } ; 

exception StartSessionException { string reason; } ; 

exception GetSessionStatusException { string reason; } ; 

exception FallbackException { string reason; } ; 

exception EndSessionException { string reason; } ; 

exception AbortSessionOperationException { string reason; } ; 

exception GetSessionldsException { string reason; } ; 

/* 

Defines the System interface of a EM. It defines all methods which are 

necessary to control a configuration session from a IRPManager. 

interface BulkCmIRP 
{ 

Return the list of all supported Bulk CM IRP versions. 

ManagedGenericIRPConstDef s : : VersionNumberSet get_bulk_cm_irp_versions ( 

) 

raises (GetBulkCmlRPVersionsException) ; 

/* 

Return the list of all supported operations and their supported 

parameters for a specific BulkCM IRP version. 

ManagedGenericIRPConstDef s : :MethodList get_bulk_cm_irp_operation_prof ile ( 

in ManagedGenericIRPConstDef s : : VersionNumber bulk_cm_irp_version 
) 
raises (GetBulkCMIRPOperationProf ileException, 

ManagedGenericIRPSystem: rOperationNotSupported, 

ManagedGenericIRPSystem: : InvalidParameter) ; 

Return the list of all supported notifications and their supported 
parameters for a specific BulkCM IRP version. 

ManagedGenericIRPConstDef s : :MethodList 
get_bulk_cm_irp_notif ication_prof ile 
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( 

in ManagedGenericIRPConstDef s : : VersionNumber bulk_cm_irp_version 
) 
raises (GetBulkCMIRPNotif icationProf ileException, 

ManagedGenericIRPSystem: rOperationNotSupported, 

ManagedGenericIRPSystem: : InvalidParameter) ; 

Uploads a configuration from the subnetwork. The result is put in a 

configuration data file in an area specified by the IRPManager. 

The MIB of the subnetwork is iterated by means of containment search, 

using a SearchControl to control the search and the returned results. 

All MOs in the scope constitutes a set that the filter works on. 

In case of a concurrent running session the function will 

return an exception. If the value of the given baseObject or Filter 

does not exist then this asynchronous error condition will be notified. 

*/ 

void upload ( 

in BulkCmlRPConstDefs: 
in BulkCmlRPConstDefs: 
in BulkCmlRPConstDefs: 

in BulkCmlRPConstDefs: _ 

) 
raises (UploadException, UnknownSessionldException, 

MaxSessionReachedException, NotValidlnCurrentStateException, 

ConcurrencyExcept ion , 

I llegalDNFormat Except ion, I 1 legal FilterFormat Except ion, 

II legal ScopeTypeExcept ion, II legal ScopeLevelExcept ion, 

I llegalURLFormat Except ion, 

ManagedGenericIRPSystem: : InvalidParameter) ; 

Indicates the EM that it can download a configuration data file from 
a given configuration data file storage area. The EM will check the 
consistence of the configuration data and the software compatibilty . 

void download ( 

in BulkCmlRPConstDef s :: Sessionid session_id, 
in BulkCmlRPConstDef s :: FileDestination source 
) 
raises (DownloadException, UnknownSessionldException, 

MaxSessionReachedException, NotValidlnCurrentStateException, 
I llegalURLFormat Except ion, 
ManagedGenericIRPSystem: : InvalidParameter) ; 

Activates a previously downloaded and sucessfully parsed configuration 
inside a session. This means that the configuration will be introduced 
in the live sub-network. In case of a concurrent running session 
the function will return an exception. 

void activate ( 

in BulkCmlRPConstDef s :: Sessionid session_id, 

in BulkCmlRPConstDef s : :ActivationModeTypeOpt activation_mode, 
in boolean fallback 
) 
raises (ActivateException, UnknownSessionldException, 

NotValidlnCurrentStateException, ConcurrencyExcept ion, 
1 1 legalAc t ivat ionModeExcept ion , 

ManagedGenericIRPSystem: : ParameterNotSupported, 
ManagedGenericIRPSystem: : InvalidParameter) ; 

Uploads a log from the subnetwork which is usally used for error 
analysis. The log is put in a logfile in the filesystem which can 
be accessed by the EM. If there are no log entries an empty log file 
is uploaded. 

void get_session_log ( 

in BulkCmlRPConstDef s :: FileDestination sink, 
in BulkCmlRPConstDef s :: Sessionid session_id, 
in boolean only_error_inf o 
) 

raises (GetSessionLogException, UnknownSessionldException, 
I llegalURLFormat Except ion, 
ManagedGenericIRPSystem: : InvalidParameter) ; 

/* 
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Creates an instance of the configuration session state machine. The 
IDLE_PHASE & COMPLETED is notified 

void start_session ( 

in BulkCmlRPConstDef s : : Sessionid session_id 
) 
raises (StartSessionException, SessionldlnUseException, 

MaxSess ionReachedExcept ion , 

ManagedGenericIRPSystem: : InvalidParameter) ; 

/* 

Returns the state of a configuration session. 

BulkCmlRPConstDef s :: SessionState get_session_status ( 

in BulkCmlRPConstDef s :: Sessionid session_id, 

out BulkCmlRPConstDef s :: Errorlnformation error_inf ormation 
) 

raises (GetSessionStatusException, UnknownSessionldException, 
ManagedGenericIRPSystem: : InvalidParameter) ; 

/* 

Actives a fallback area. Each time a configuration is activated a 

fallback area can be created, s. activate parameter. 

This area is backup of the complete configuration which can be 

restored by this method. The process is as follows: 

1 . When the method activate (...,..., TRUE) is used, 

a copy of the valid area is taken before the activation 

of the new planned data has started. Only one fallback area can 

exists at a time for a specific scope of the subnetwork. 

2 . When a fallback area is avilable and triggered by this method, the 
previous valid area is replaced with the data stored in 

the fall back area. 
If the EM detects that the former configuration has never been 
changed it returns an exception because it does not trigger an 
activation of the former data. 

void fallback ( 

in BulkCmlRPConstDef s :: Sessionid session_id 
) 
raises (FallbackException, UnknownSessionldException, NoFallbackException, 

NotValidlnCurrentStateException, ConcurrencyException, 

ManagedGenericIRPSystem: : InvalidParameter) ; 

The IRPManager invokes this operation to delete all its temporary 
entities and the related sessionid which belong to the scope of 
a configuration session. This includes the related error and log 
informationen too. 

void end_session ( 

in BulkCmlRPConstDef s :: Sessionid session_id 
) 
raises (EndSessionException, UnknownSessionldException, 

NotValidlnCurrentStateException, 

ManagedGenericIRPSystem: : InvalidParameter) ; 

The IRPManager invokes this operation to abort an active operation 
during a configuration session. It is only effecting 
a configuration session in state IN_PROGRESS . In this case the 
current session task is interrupted, e.g. the activating in progress, 
using best effort strategy, and a state change is notified 

void abort_session_operation ( 

in BulkCmlRPConstDef s :: Sessionid session_id 
) 
raises ( Abort SessionOperationExcept ion, UnknownSessionldException, 

NotValidlnCurrentStateException, 

ManagedGenericIRPSystem: : InvalidParameter) ; 

Returns a list all sessionlds of current running configuration sessions. 

BulkCmlRPConstDef s :: SessionldList get_session_ids ( 

) 

raises (GetSessionldsException) ; 

/* 
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Validates previously downloaded bulk configuration data inside a session. 
Detects errors in the data prior to requesting preactivation or 
activation. 

void validate ( 

in BulkCmlRPConstDef s : : Sessionid session_id, 

in BulkCmlRPConstDef s : :ActivationModeTypeOpt activation_mode 
) 
raises (ValidateException, UnknownSessionldException, 

NotValidlnCurrentStateException, ConcurrencyException, 
1 1 legalAc t ivat ionModeExcept ion , 



ManagedGenericIRPSystem 
ManagedGenericIRPSystem 
ManagedGenericIRPSystem 



ParameterNot Supported, 
InvalidParameter, 
OperationNotSupported) ; 



Preactivates previously downloaded bulk configuration data inside a 
session. This operation validates configuration data changes in the 
context of the current data and pre-processes the configuration data 
changes . 

void preactivate ( 

in BulkCmlRPConstDef s: 
in BulkCmlRPConstDef s : 
in BulkCmlRPConstDef s : 
in boolean fallback 
) 
raises (PreactivateException, UnknownSessionldException, 

NotValidlnCurrentStateException, ConcurrencyException, 

I llegalAct ivat ionModeExcept ion, I llegalVerificat ionModeExcept ion. 



Sessionid session_id, 

Verif icationModeTypeOpt verif ication_mode. 

Act ivat ionModeTypeOpt act ivat ion_mode. 



ManagedGenericIRPSystem 
ManagedGenericIRPSystem 
ManagedGenericIRPSystem 



ParameterNot Supported, 
InvalidParameter, 
OperationNotSupported) ; 



module SimpleUploadBulkCMIRPSystem 

{ 

exception GetSimpleUploadBulkCmlRPVersionsException { string reason; } ; 
exception GetSimpleUploadBulkCMIRPOperationProf ileException 

{ string reason; } ; 
exception GetSimpleUploadBulkCMIRPNotificationProf ileException 

{ string reason; } ; 

interface SimpleUploadBulkCMIRP 
{ 

Return the list of all supported Bulk CM IRP versions. 

ManagedGenericIRPConstDef s : : VersionNumberSet 

get_simple_upload_bulk_cm_irp_versions ( 
) 
raises (GetSimpleUploadBulkCmlRPVersionsException) ; 

/* 

Return the list of all supported operations and their supported 

parameters for a specific BulkCM IRP version. 

ManagedGenericIRPConstDef s : :MethodList 

get_simple_upload_bulk_cm_irp_operation_prof ile ( 

in ManagedGenericIRPConstDef s : : VersionNumber bulk_cm_irp_version 
) 

raises ( Get SimpleUploadBulkCMIRPOperationProf ileException, 
ManagedGenericIRPSystem: : OperationNotSupported, 
ManagedGenericIRPSystem: : InvalidParameter) ; 

Return the list of all supported notifications and their supported 
parameters for a specific BulkCM IRP version. 

ManagedGenericIRPConstDef s : :MethodList 

get_simple_upload_bulk_cm_irp_notif ication_prof ile 

( 

in ManagedGenericIRPConstDef s : : VersionNumber bulk_cm_irp_version 

) 

raises (GetSimpleUploadBulkCMIRPNotificationProf ileException, 
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ManagedGenericIRPSystem: rOperationNotSupported, 
ManagedGenericIRPSystem: : InvalidParameter) ; 

Uploads a configuration from the subnetwork. The result is put in a 

configuration data file in an area specified by the IRPManager. 

The MIB of the subnetwork is iterated by means of containment search, 

using a SearchControl to control the search and the returned results. 

All MOs in the scope constitutes a set that the filter works on. 

In case of a concurrent running session the function will 

return an exception. If the value of the given baseObject or Filter 

does not exist then this asynchronous error condition will be notified. 



*/ 

void upload ( 

in BulkCmlRPConstDefs 
in BulkCmlRPConstDefs 
in BulkCmlRPConstDefs 
in BulkCmlRPConstDefs 

) 

raises ( 

BulkCmlRPSystem : 
BulkCmlRPSystem : 
BulkCmlRPSystem : 
BulkCmlRPSystem : 
BulkCmlRPSystem : 
BulkCmlRPSystem : 
BulkCmlRPSystem : 
BulkCmlRPSystem : 
BulkCmlRPSystem : 
BulkCmlRPSystem : 



Sessionid session_id, 
FileDestination sink, 
DistinguishedName base_object, 
SearchControl search control 



UploadException, 

UnknownSessionldException, 

MaxSess ionReachedExcept ion , 

NotValidlnCurrentStateException, 

ConcurrencyExcept ion , 

I llegalDNFormat Except ion, 

I 1 legal FilterFormat Except ion, 

II legal ScopeTypeExcept ion, 

II legal ScopeLevelExcept ion, 

I llegalURLFormat Except ion. 



ManagedGenericIRPSystem: : InvalidParameter) ; 

}; 

} ; // end of module SimpleUploadBulkCMIRPSystem 
module ControlledUploadBulkCMIRPSystem 

{ 

exception GetControlledUploadBulkCmlRPVersionsException { string reason; } ; 
exception GetControlledUploadBulkCMIRPOperationProf ileException 

{ string reason; } ; 
exception GetControlledUploadBulkCMIRPNotificationProf ileException 

{ string reason; } ; 

interface ControlledUploadBulkCMIRP 
{ 

Return the list of all supported Bulk CM IRP versions. 

ManagedGenericIRPConstDef s : : VersionNumberSet 

get_controlled_upload_bulk_cm_irp_versions ( 
) 
raises (GetControlledUploadBulkCmlRPVersionsException) ; 

Return the list of all supported operations and their supported 
parameters for a specific BulkCM IRP version. 

ManagedGenericIRPConstDef s : :MethodList 

get_controlled_upload_bulk_cm_irp_operation_prof ile ( 

in ManagedGenericIRPConstDef s : : VersionNumber bulk_cm_irp_version 
) 
raises (GetControlledUploadBulkCMIRPOperationProf ileException, 

ManagedGenericIRPSystem: :OperationNotSupported, 

ManagedGenericIRPSystem: : InvalidParameter) ; 

Return the list of all supported notifications and their supported 
parameters for a specific BulkCM IRP version. 

ManagedGenericIRPConstDef s : :MethodList 

get_controlled_upload_bulk_cm_irp_notif ication_prof ile ( 

in ManagedGenericIRPConstDef s : : VersionNumber bulk_cm_irp_version 
) 

raises (GetControlledUploadBulkCMIRPNotificationProf ileException, 
ManagedGenericIRPSystem: :OperationNotSupported, 
ManagedGenericIRPSystem: : InvalidParameter) ; 

/* 
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Uploads a configuration from the subnetwork. The result is put in a 

configuration data file in an area specified by the IRPManager. 

The MIB of the subnetwork is iterated by means of containment search, 

using a SearchControl to control the search and the returned results. 

All MOs in the scope constitutes a set that the filter works on. 

In case of a concurrent running session the function will 

return an exception. If the value of the given baseObject or Filter 

does not exist then this asynchronous error condition will be notified. 

*/ 

void upload ( 

in BulkCmlRPConstDefs 

in BulkCmlRPConstDefs 

in BulkCmlRPConstDefs 

in BulkCmlRPConstDefs 
) 
raises ( 

BulkCmlRPSystem 

BulkCmlRPSystem 

BulkCmlRPSystem 

BulkCmlRPSystem 

BulkCmlRPSystem 

BulkCmlRPSystem 

BulkCmlRPSystem 

BulkCmlRPSystem 

BulkCmlRPSystem 

BulkCmlRPSystem 



Sessionid session_id, 
FileDestination sink, 
DistinguishedName base_object, 
SearchControl search control 



UploadException, 

UnknownSessionldException, 

MaxSess ionReachedExcept ion , 

NotValidlnCurrentStateException, 

ConcurrencyExcept ion , 

I llegalDNFormat Except ion, 

I 1 legal FilterFormat Except ion, 

II legal ScopeTypeExcept ion, 

II legal ScopeLevelExcept ion, 

I llegalURLFormat Except ion. 



ManagedGenericIRPSystem: : InvalidParameter) ; 

Uploads a log from the subnetwork which is usally used for error 
analysis. The log is put in a logfile in the filesystem which can 
be accessed by the EM. If there are no log entries an empty log file 
is uploaded. 

void get_session_log ( 

in BulkCmlRPConstDef s :: FileDestination sink, 

in BulkCmlRPConstDef s :: Sessionid session_id, 

in boolean only_error_info 
) 
raises ( 

BulkCmlRPSystem : 

BulkCmlRPSystem : 

BulkCmlRPSystem : 



GetSessionLogException, 
UnknownSessionldException, 
I llegalURLFormat Except ion. 



ManagedGenericIRPSystem: : InvalidParameter) 



Creates an instance of the configuration session state machine. 
IDLE PHASE & COMPLETED is notified 



The 



void start_session ( 

in BulkCmlRPConstDefs: 

) 

raises ( 

BulkCmlRPSystem : 
BulkCmlRPSystem : 
BulkCmlRPSystem : 



: Sessionid session id 



StartSessionException, 
SessionldlnUseException, 
MaxSess ionReachedExcept ion , 



ManagedGenericIRPSystem: : InvalidParameter) ; 

Returns the state of a configuration session. 

BulkCmlRPConstDef s :: SessionState get_session_status ( 
in BulkCmlRPConstDef s :: Sessionid session_id, 
out BulkCmlRPConstDef s : :ErrorInformation error_inf ormation 

) 

raises ( 

BulkCmlRPSystem: :GetSessionStatusException, 
BulkCmlRPSystem: : UnknownSessionldException, 
ManagedGenericIRPSystem: : InvalidParameter) ; 



The IRPManager invokes this operation to delete all its temporary 
entities and the related sessionid which belong to the scope of 
a configuration session. This includes the related error and log 
inf ormationen too. 

void end_session ( 

in BulkCmlRPConstDef s :: Sessionid session id 
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) 

raises ( 

BulkCmlRPSystem : 
BulkCmlRPSystem : 
BulkCmlRPSystem : 



EndSessionException, 

UnknownSessionldException, 

NotValidlnCurrentStateException, 



ManagedGenericIRPSystem: : InvalidParameter) ; 

The IRPManager invokes this operation to abort an active operation 
during a configuration session. It is only effecting 
a configuration session in state IN_PROGRESS . In this case the 
current session task is interrupted, e.g. the activating in progress, 
using best effort strategy, and a state change is notified 

void abort_session_operation ( 

in BulkCmlRPConstDef s : : Sessionid session_id 
) 
raises ( 



BulkCmlRPSystem : 
BulkCmlRPSystem : 
BulkCmlRPSystem : 



Abort SessionOperationExcept ion, 

UnknownSessionldException, 

NotValidlnCurrentStateException, 



ManagedGenericIRPSystem: : InvalidParameter) ; 

Returns a list all sessionlds of current running configuration sessions. 

BulkCmlRPConstDef s :: SessionldList get_session_ids ( 

) 

raises ( 

BulkCmlRPSystem: :GetSessionIdsException) ; 



} ; // end of module ControlledUploadBulkCMIRPSystem 
#endif // BULK CM IRP SYSTEM IDL 
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A.3 IDL specification (file name 
'BulkCIVIIRPNotifications.idI') 

//File: BulkCMNotif ications. idl 

#ifndef _BULK_CM_IRP_NOTIFICATIONS_IDL_ 

#define _BULK_CM_IRP_NOTIFICATIONS_IDL_ 

#include <NotificationIRPNotif ications . idl> 
#include <BulkCmIRPConstDef s . idl> 

// This statement must appear after all include statements 
#pragma prefix "3gppsa5.org" 

module BulkCMIRPNotif ications 

{ 

interface NotifySessionStateChange : NotificationlRPNotif ications : rNotify 

{ 

// This is the type_name (2nd field) of the fixed header, 
const string EVENT_TYPE = 

BulkCmlRPConstDefs: :Notif icationType : :NOTIFY_SESSION_STATE_CHANGED; 

// 

// One of the strings here is the event_name (3rd field) of the 

// fixed header. 

// The first 2 are relevant for IS-defined packages Simple 

// Upload and Controlled Upload. 

// All are relevant for IS-defined package 

// Controlled Upload & Provisioning. 

const string UPLOAD_FAILED = BulkCmlRPConstDefs:: 

SessionStateChangeNotif ication: :UPLOAD_FAILED; 
const string UPLOAD_COMPLETED = BulkCmlRPConstDefs:: 

SessionStateChangeNotif ication: : UPLOAD_COMPLETED ; 
const string DOWNLOAD_FAILED = BulkCmlRPConstDefs:: 

SessionStateChangeNotif ication: :DOWNLOAD_FAILED; 
const string DOWNLOAD_COMPLETED = BulkCmlRPConstDefs:: 

SessionStateChangeNotif ication: : DOWNLOAD_COMPLETED ; 
const string ACTIVATION_FAILED = BulkCmlRPConstDefs:: 

SessionStateChangeNotif ication: : ACTIVATION_FAILED; 
const string ACTIVATION_PARTLY_REALISED = BulkCmlRPConstDefs:: 

SessionStateChangeNotif ication: : ACTIVATION_PARTLY_REALISED; 
const string ACTIVATION_COMPLETED = BulkCmlRPConstDefs:: 

SessionStateChangeNotif ication: : ACTIVATION_COMPLETED; 
const string FALLBACK_FAILED = BulkCmlRPConstDefs:: 

SessionStateChangeNotif ication: : FALLBACK_FAILED; 
const string FALLBACK_PARTLY_REALISED = BulkCmlRPConstDefs:: 

SessionStateChangeNotif ication: : FALLBACK_PARTLY_REALISED; 
const string FALLBACK_COMPLETED = BulkCmlRPConstDefs:: 

SessionStateChangeNotif ication: : FALLBACK_COMPLETED ; 
const string VALIDATION_FAILED = BulkCmlRPConstDefs:: 

SessionStateChangeNotif ication: : VALIDATION_FAILED; 
const string VALIDATION_COMPLETED = BulkCmlRPConstDefs:: 

SessionStateChangeNotif ication: : VALIDATION_COMPLETED; 
const string PREACTIVATION_FAILED = BulkCmlRPConstDefs:: 

SessionStateChangeNotif ication: : PREACTIVATION_FAILED; 
const string PREACTIVATION_PARTLY_REALISED = BulkCmlRPConstDefs:: 

SessionStateChangeNotif ication: : PREACTIVATION_PARTLY_REALISED; 
const string PREACTIVATION_COMPLETED = BulkCmlRPConstDefs:: 

SessionStateChangeNotif ication: : PREACTIVATION_COMPLETED; 
// 

const string SESSION_ID = 

BulkCmlRPConstDefs: :AttributeName Value : :SESSION_ID; 

const string SOURCE_INDICATOR = 

BulkCmlRPConstDefs: :AttributeName Value : : SOURCE INDICATOR; 



interface NotifyGetSessionLogEnded: NotificationlRPNotif ications : :Notify 

{ 

// This is the type_name (2nd field) of the fixed header, 
const string EVENT_TYPE = 

BulkCmlRPConstDefs: : Not if icationType : :NOTIFY_GET_SESSION_LOG_ENDED; 
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// 

// One of the 2 strings here is the event_name (3rd field) of the 
// fixed header. 

const string GET_SESSION_LOG_COMPLETED_SUCCESSFULLY = 
BulkCmlRPConstDefs: : LogStateNotif ication : : 
GET_SESSION_LOG_COMPLETED_SUCCESSFULLY; 
const string GET_SESSION_LOG_COMPLETED_UNSUCESSFULLY = 
BulkCmlRPConstDefs: : LogStateNotif ication : : 
GET_SESSION_LOG_COMPLETED_UNSUCESSFULLY; 
// 

const string SESSION_ID = 

BulkCmlRPConstDefs: :AttributeName Value : :SESSION_ID; 

const string SOURCE_INDICATOR = 

BulkCmlRPConstDefs: :AttributeName Value : : SOURCE_INDICATOR; 



#endif // BULK CM IRP NOTIFICATIONS IDL 
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Annex B (informative): 
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